ATSUTextMoved

OSStatus ATSUTextMoved (
ATSUTextLayout iTextLayout,
ConstUniCharArrayPtr iNewLocation);

iTextLayout

A reference of type ATSUTextLayout. Pass a reference to an initialized text layout object. You cannot pass NULL for this parameter.

iNewLocation

A pointer of type ConstUniCharArrayPtr. Pass the beginning of the updated location of the text buffer physical memory of the text buffer.

function result

A result code. See Result Codes.

DISCUSSION

The ATSUTextMoved function updates the location of text in physical memory to reflect the location that you moved the buffer to. You are responsible for moving the text. The text buffer should remain otherwise unchanged.

If the user deletes, inserts, or moves text in a text layout object and the range of text covers the entire text buffer, you should not call ATSUTextMoved. Instead,

call the function ATSUSetTextPointerLocation or ATSUSetTextHandleLocation to update the text
call the function ATSUSetRunStyle to update the style runs

You can then call the function ATSUDrawText to display the updated text.

VERSION NOTES

Available beginning with ATSUI 1.0.